home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Scope / Scope Disk #060 (199x)(Scope PD)(US)[WB].zip / Scope Disk #060 (199x)(Scope PD)(US)[WB].adf / HandyIcon / Handy_Doc < prev    next >
Text File  |  1989-02-21  |  9KB  |  240 lines
  1.                *** New Information Appended ***
  2. February, 1989            HandyIcons           Shareware $10
  3.  
  4.      HandyIcons is an extension to the Workbench menu strip
  5. which permits the user to run user-selectable Tools/Projects
  6. by menu selection. The number of selectable icons is limited
  7. to type size and the vertical resolution of your Workbench
  8. screen.
  9.  
  10.                      Tool/Project Selection
  11.      Icons can be selected by the user in two ways:
  12.  
  13.                * Workbench Extended Selection
  14.                * Workbench Tool Types
  15.  
  16.      Extended Selection is the more flexible method of
  17. selection. The Icons selected in this way will be displayed
  18. before those selected by Tool Types. To use this technique:
  19.  
  20.      * Open disks, drawers, ect. to display the Icons of
  21.        interest
  22.  
  23.      * Press the mouse select button over a blank part of
  24.        the screen or window to insure deselection of all
  25.        other icons
  26.  
  27.      * Select the HandyIcons icon first
  28.  
  29.      * Select your menu Icons While pressing a Shift key
  30.  
  31.      * Release the Shift key, go to the Workbench menu, and
  32.        choose Open ( Shortcut: On the last Icon double-click)
  33.  
  34.      Tool Types is the way to select Icons without going
  35. through the effort of Extended Selection every time. It's
  36. possible to use Extended Selection and Tool Types simul-
  37. taneously, but if you select more Icons than displayable
  38. those at the bottom of this list won't be rendered.
  39. To use this technique:
  40.  
  41.      * Select the HandyIcons icon
  42.  
  43.      * Choose Info from the Workbench menu
  44.  
  45.      * Select the Add gadget & Type Pathname(s)
  46.        to your Icon(s)
  47.  
  48.      * Select the Save gadget when finished
  49.  
  50.      The next time you run the program these Icons will
  51. automatically be included in your menu.
  52. Some examples and suggestions:
  53.  
  54.  Clock          ________________ /These Icons would be in the
  55.  Preferences                     \same drawer as this Program
  56.  Utilities/Notepad   ------------<Just one directory deep
  57.  Extras:AmigaBASIC               /It's wise to use
  58.  Extras:Tools/MicroEmacs -------< Volume names (Extras:)
  59.  Extras:Tools/Fed                \whenever possible
  60.  Extras:BasicDemos/Demo  --------<Project
  61.  
  62.        Note: Even though it's permissible to use relative
  63. pathnames, your safest bet is using full volume & pathnames.
  64. This insures HandyIcons will find the Tool/Project no matter
  65. what directory HandyIcons resides.
  66.  
  67.  
  68.                           HandyWB
  69.  
  70.      HandyWB is the way to start HandyIcons from a CLI.
  71. The main purpose for HandyWB is to spawn HandyIcons as a
  72. separate process so the initial CLI exits. Only the Tool
  73. Types method of selection applies, but by placing it in
  74. your startup-sequence it's possible to have menu access
  75. to your favorite programs immediately.
  76.  
  77.      Using HandyWB without any arguments defaults to looking
  78. for the HandyIcons program in Sys:System drawer (Sys:System/
  79. HandyIcons). If for some reason you don't want HandyIcons
  80. there, simply add the true pathname as the first argument.
  81.  
  82.      ex. HandyWB Extras:Tools/HandyIcons
  83.  
  84.      If you're going to start HandyIcons using HandyWB then
  85. you must keep the first ten characters "HandyIcons" but you
  86. may add extensions to signify different tool type arrays.
  87. To take advantage of this:
  88.  
  89.      * Copy HandyWB to your C: directory
  90.  
  91.      * Place HandyIcons in Sys:System drawer (or elsewhere)
  92.  
  93.      * Edit your startup-sequence and place HandyWB
  94.        AFTER LoadWB
  95.  
  96.      * IMPORTANT: The old HandyWB WILL NOT START the
  97.                      new HandyIcons!!!
  98.  
  99. ************************************************************
  100. *   MODIFICATIONS MADE TO HandyIcons SINCE LAST JULY '88   *
  101. ************************************************************
  102.  
  103.  
  104.      * HandyIcons will now run when it finds
  105.          Workbench Version 33 or 34
  106.  
  107.      * Project Support
  108.          CLI programs with a program like IconX or Xicon
  109.  
  110.      * Menu Swapping
  111.  
  112.      * Immediate Exit
  113.          The job of cleaning up after a program
  114.          has be given to Workbench
  115.  
  116.      * Screen Flash on errors
  117.  
  118.      * Rewritten in Assembly Language
  119.  
  120.    If you have extra vertical space, HandyIcons now places
  121. a little room between menu items. This is especially nice
  122. for those of you who run an interlace Workbench; only you
  123. can't fit as many Tool/Proj in, so if it's going to cost you
  124. an entry the program applies the big squeeze and jams in as
  125. many Tool/Proj as possible. (Just like before)
  126.  
  127.                      Menu Swapping
  128.  
  129.    One of the more serious limitations imposed by Handy-
  130. Icons is the number of Tool/Proj available at any given
  131. time. This new feature is implemented to help ease that
  132. situation.
  133.    As you know, it's possible to have multiple copies of
  134. HandyIcons on your disk--each with its own list of Tools/
  135. Projects. Place these copies in your HandyIcons menu and
  136. selection will cause the program to reset its menu to
  137. the newly selected icon's ToolTypes array.
  138.  
  139.    Two conditions must be met:
  140.       1) The first 9 characters must be "HandyIcon" in
  141.          order for the program to recognize a menu swap.
  142.       2) Arguments must be present in the icon's
  143.          ToolTypes.
  144.  
  145. For Example:
  146.    I use the default Workbench screen (640x200) using
  147. topaz 8 (80 column). In this configuration I can set 17
  148. items in the menu (22 using the big squeeze). Personally
  149. I prefer a little space between menu items, so I'm not
  150. going to place any more than 17 selections in each array.
  151. Assuming I have 64 Tool/Projects, one possible implemen-
  152. tation could be as follows:
  153. Remember, only one menu is displayed at any time.
  154.  
  155. HandyIcons     HandyIcons1    HandyIcons2    HandyIcons3
  156. -------------|--------------|--------------|-------------
  157. Tool/Proj#1  | Tool/Proj#17 | Tool/Proj#33 | Tool/Proj#49
  158.    thru      |    thru      |    thru      |    thru
  159. Tool/Proj#16 | Tool/Proj#32 | Tool/Proj#48 | Tool/Proj#64
  160. HandyIcons1  | HandyIcons2  | HandyIcons3  | HandyIcons
  161. Exit         | Exit         | Exit         | Exit
  162.  
  163.    The above demonstrates a single-linked list: sixteen
  164. slots for Tool/Proj and one slot dedicated to menu swap-
  165. ping with the last menu pointing back to the first. Se-
  166. lecting the last item in each will bring up the new menu.
  167.  
  168.    Why not double-linked lists with two slots dedicated?
  169.      (one forward & one backward)
  170.  
  171.    Why not three slots dedicated?
  172.      (in the above example, you could get TO any menu
  173.       FROM any menu)
  174.  
  175.    Need more slots? Add another program.
  176.    The decisions are yours!
  177.  
  178.                         One Caveat
  179.  
  180.    After a new preferences HandyIcons and Workbench each
  181. begin the process of rebuilding their respective menus.
  182. Depending on how many windows Workbench is dealing with,
  183. the syncronization gets touchy and the possibility exists
  184. that if you try a menu operation during this period you may
  185. lose the extra menu.
  186.  
  187.                     A Simple Solution
  188.  
  189.    So, what do you do to avoid this nasty little predicament?
  190. After preferences, just hold off that menu finger for a sec,
  191. perhaps two, and everything will be just (dare I say) handy
  192. dandy. When you can't see any more screen activity then that
  193. is a good indication it's safe.
  194.    And if you find that it is, in fact, missing? Selecting an
  195. icon or pressing the select button on any blank portion of
  196. any one of Workbench's windows will bring 'er back.
  197. (Which is what will eventually happen anyway)
  198.  
  199.  
  200.                    1.4 Compatability?
  201.  
  202.    HandyIcons is a "rebel" program. There are no system calls
  203. for adding a menu to Workbench. To accomplish its task it ac-
  204. cesses the "private" data fields and message ports of Work-
  205. bench. "Private" means CBM does not guarantee their positions
  206. from release to release. Therefore, this program aborts if it
  207. doesn't find version 33 or 34. If the program were allowed to
  208. run with position changes (and 1.4 sounds like a major re-
  209. write) HandyIcons would crash with unpredictable results!
  210.   Unfortunately, in the February 1989 issue of AMIGA
  211. TRANSACTOR, Mr. Khalid Aldoseri "comes to the rescue." The
  212. article actually lists step by step instructions on how to
  213. bypass the version checking mechanism! No! No! No! NO! NO!
  214.  
  215. PROGRAMMERS! DO NOT UNDERMINE MY DEFENSIVE PROGRAMMING!!!
  216. If it's there, it's there for a good reason!
  217.  
  218.    This program will run under 1.2 or 1.3 and is intended as
  219. a complete replacement, so get rid of that old program.
  220.  
  221.    Suggestions?    Comments?   Contributory Inclinations?
  222.  
  223.    Alan Rubright                  TUSK  BBS
  224.    1016 N. Duke Street        or  (717) 560-1750
  225.    Lancaster, PA  17602-1908      2400:8N1  24 Hrs
  226.  
  227. DISTRIBUTION/DISCLAIMER:   (C)  1989  Alan Rubright
  228. This program may be distributed for non-commercial use by
  229. any means as long as:
  230.    1) the program and this document file are distributed
  231.       together
  232.    2) the program, this file, or any part thereof, is not
  233.       modified or removed
  234. These rights may not be abridged except by written permis-
  235. sion from the author. The author makes no warranties, ex-
  236. pressed or implied. This program is provided "as is" and the
  237. entire risk as to its quality and performance is with the
  238. user.
  239.  
  240.